---
id: getting-started
title: Getting Started
sidebar_label: Getting Started
description: A performant carousel for React Native powered by Reanimated.
keywords:
  - react-native-reanimated-carousel
  - reanimated-carousel
  - reanimated carousel
  - react-native
  - snap-carousel
  - react native
  - snap carousel
  - ios
  - android
  - carousel
  - snap
  - reanimated
image:
slug: /
---


# React Native Reanimated Carousel
---

import { Badges } from '@/components/Badges'
import { Callout } from 'nextra/components'


<Callout emoji="👾">
  **(WIP)** If you find any mistakes, please submit an Issue to remind me to revise it, or PR is welcome.
</Callout>

<br/>
 
<div style={{borderRadius:"8px",overflow:"hidden"}}>
![Cover Image](../../../assets/home-banner.png)
</div>
<Badges />

A performant carousel for React Native powered by Reanimated. ⚡️

## Features

- The best performance you can get. 🚀
- Fully configurable. ⚙️
- Support for both `iOS` & `Android` & `Web`. 📱
- Support for `RTL` layout. 🌍
- Smooth gesture interactions & snapping animations. 🏎
- Support to customise the animation style. 🎨
- Compatible with Reanimated [v1]() & [v2](). 🎉
- Compatible with `Expo`. 🎩
- Accessibility support. ♿️
- Written in `TypeScript`. 🌳

## Installation

```bash
yarn add react-native-reanimated-carousel
```

Using Expo?

```bash
npx expo install react-native-reanimated-carousel
```

#### Dependencies

This library needs these dependencies to be installed in your project before you can use it:

```bash
yarn add react-native-reanimated react-native-gesture-handler
```

Using Expo?

```bash
npx expo install react-native-reanimated react-native-gesture-handler
```

<Callout type="warning" emoji="⚠️">
**React Native Gesture Handler** needs extra steps to finalize its installation, please follow their [installation instructions](https://docs.swmansion.com/react-native-gesture-handler/docs/installation). Please **make sure** to wrap your App with `GestureHandlerRootView` when you've upgraded to React Native Gesture Handler ^2.

**React Native Reanimated v2** needs extra steps to finalize its installation, please follow their [installation instructions](https://docs.swmansion.com/react-native-reanimated/docs/fundamentals/getting-started).
</Callout>


## Special thanks

<video src="quick-swipe.mp4" autoPlay loop muted className="w rounded-xl mt-2"/>
<div className="flex flex-row items-center justify-center p-4 rounded-lg mb-4 mt-4 ss-content ">
  <img src='SSLogo.webp' className="animate-spin w-20 h-20 mr-4" style={{ animationDuration: '3000ms' }}/>
  <div>
    <p className="font-bold mb-2 text-2xl">Screen Studio</p>
    <p className="text-sm">Thanks to <a className="font-bold underline text-[#792fdc]" href="https://www.screen.studio/@nGeEY">Screen Studio</a> for sponsoring this library. You can use Screen Studio to record your screen and edit videos and get beautiful screen recordings in minutes.</p>
  </div>
</div>


## Sponsor & Support
To keep this library maintained and up-to-date please consider sponsoring to us. ☕️

- [Caspian](https://github.com/sponsors/dohooo) 
- [GX](https://github.com/gxxgcn)
- [Oliver Lopez](https://github.com/sponsors/oliverloops) 

<p align="center">
  <img src='https://github.com/dohooo/sponsors/blob/master/sponsors.png?raw=true'/>
</p>

## More high quality libraries made by me 🚀

- [react-native-reanimated-table](https://github.com/dohooo/react-native-reanimated-table)

## Built With ❤️

- [react-native-reanimated](https://github.com/software-mansion/react-native-reanimated)
- [react-native-gesture-handler](https://github.com/software-mansion/react-native-gesture-handler)
- [react-native-redash](https://github.com/wcandillon/react-native-redash)
- [react-native-builder-bob](https://github.com/callstack/react-native-builder-bob)
